Inside Macintosh: QuickDraw GX Objects /

Chapter 5 - Ink Objects / Ink Objects Reference

Functions / Creating and Manipulating Ink Objects

GXCloneInk

You can use the GXCloneInk function to clone an ink object--that is, to add a reference to it and increment its owner count.

gxInk GXCloneInk(gxInk source);

source

A reference to the ink object to clone.

function result

A reference to the cloned ink.

DESCRIPTION

The GXCloneInk function increments the owner count of the ink referenced in the source parameter. You typically use this function when you want to create another reference to an existing ink instead of creating a distinct copy of the ink.

This function returns as its function result a reference to the ink--the same reference you pass in as the source parameter. It also increments the ink's owner count.

ERRORS, WARNINGS, AND NOTICES

Errors
ink_is_nil

SEE ALSO

Owner counts for ink objects are discussed in the section "Copying, Comparing, and Cloning Ink Objects" beginning on page 5-39, and in the section "Manipulating an Ink Object's Owner Count" beginning on page 5-41.

To examine the owner count of an ink, use the GXGetInkOwners function, described on page 5-64. To decrement the owner count of an ink, use the GXDisposeInk function, described on page 5-57.